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The "HANDY" disk idea came about because there are many programs 
written under APEX, Many of these programs are of the xind that 
are handy for any AFEX user, Gut are not yet, or perhaps never 
will be, in a state suitable for formal distribution. 


After you investigate this first handy disk I feel sure you will 
agree that there has to be some way to make it worth while 
getting these programs out, 


Thus the abject is to provide a mechanism by which APEX programs 
can be made available to those people who are not directly in 
contact with other APEX users, 


The programs on an APEX handy disk are not guranteed in any way, 
However the disks are not free either, because someone has to 
cooy and distribute them. Some programs on these disks may pay a 
small royfaty to their developers, which 1s a good idea because 
that encorages contributions to further disks. Programs on handy 
disks may also turn up later as more formal offerings, so the 
rights remain reserved by the authors, and the programs are for 
personal use by the disk purchaser only, | 


The price of handy disks will float, depending upon royalty and 
distribution agreements, The contents, too, may change with 
times 


If you generate some handy programs you might like to share, you 
can send them to me} 


PJ... Bovle 
4334 E 17th. 
Denver, Col, 20220 


Flease include the documentation on the disk if possible and 
remember to include your telephone number. I will pass the 
program along to the appropriate person for evaluation ste. 
If you feel your work warrants a Significant royaity you should 
contact one of the APEX distributors directly, 
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several Apex handlers are present on this disk, Currently they 


ams 


yu 


CONTO 
YVIDEX 
FARHAN 


LOMHAN 


ALOSER 


The standerd console nandler (far referance), 

A comsole mandler for systems witha Videx poard. 

A handler for the Apple parallel heard connected 

to a Centronics printer, | 

A handler far the Apple communications esrd driving 
am RS2Z32 printer at 300 aud, 

A handler for ‘the SSM ALON hoard driving an RSZs2Z 


) Ved dee Ved hoo 


printer (Setup for thre fl S10. @ 2200 berid). 


These handlers are not supposed to be a complete set. They 
are examples, Thats why you received the sources, | 


Note that many handlers use the same memory space, The 
assumption is that you only need one oprinter handler, for 
example, If this is not true you can tweak the sources 
appropriately. 


In general the APEX convention with respect to handlers is that 
to install a handler you just run the corresponding SAV file. If 
you want the handler to be permanent and be in your system every 
time you boot, you must run INIT and BCOTER immediately after 
installing the new handler. 


Such SAV files must have the SYSBOME flag set to false ("F") in 
order to work because otherwise APEX will simply assume that 
they were "USER" programs and restore the handler area fram the 
disk, thus erasing fhe handler just installed. Thus in arder to 
make an auto-install file from a new handler you have just 
written, vou must make a SAV file from it and then use SET to 
fix SYBOMB in the SAV file, 


VED 


VED comes in at least two versions, one for the 40 character 


Apple screen and one for the Videx 30 character Board. The usual 
Videx version only has 44 characters for reasons of TY iimit- 
ations, A considerably more powerrul ‘and complex) versicn 


called "Ir Ec" also exists, 


This editor is a visual fidelity editor that attempts to show 
you exactly what your text looks like, It is also a scrolling 
editor that "scrolls" the screen like a "window" into your text, 
It is a typewriter editor that tries, as much as possible, to oe 
like typing on a conventional typewriter, 


Note. 


In the following we need to use the "control" key on the 
keyboard. This is a key like “shift" in that it must be held 
down while another key is being struck, We will indicate this by 
the "“" mark in the following text. Thus “control A" is written 
"A" and is typed by holding the contol key down while striking 
the A keys 


Entering the Editor, 


The editor is entered by typing EDITfreturn) to the operating 
system. The file you wish to edit is designated as usual. For 
example if your file is called "FROG.TXT" then you can edit it 
by typing: EDITispace)FROG.TXT (return), 7 


The screen format, 


The editor will reformat the screen with special lines on the 
top and bottom. The top line is the “status line" while the 
bottom line is the "command line". The rest of the screen 15 the 
"window", In the window the text you are working on will appear 
along with a moveable marker called the "cursor" which indicates 
the precise place in your text at which any editing operation 
you perform will take effect, | 


The status line consists of} 


The number of charaters of Space remaining, indicated by Ri, 
The cursor position, indicated by Ci. 

The remaining space in the "X register", indicated by Xt 
The status of the last operation performed, 


The command line holds and shows you the current deferred 
command (see below), 


Various error and information messages are placed in the status 
characters. The message “IC" indicates some I-O problem. The 
commonest cause of this message is that you are trying to read 
or write past the limits of the input or output file, 
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Immediate meade, 


The editor has two "modes", immediate and deferred, You are 
normally in immediate mode, and wnat you type takes effect 
immediately. More complex editing operations are performed in 
deferred mode wsing the cammand line, 


In immediate mode most keys you type will be taken as characters 
to be added to or inserted into your text at the cursor 
positions Some keys have special effects, like leftarrow which 
deletes the character behind: the cursor, or "RETURN" which 
begins a new line, There are not enough keys for ail the 
functione we want to perform in immediate mode so many special 
operations use “control” with a key. The immediate operations 
are listed in table 1, 


Lefered made, 


In deferred mode you can execute complex sequences of editing 
Operations. These operations are defined in the command line at 
the bottom of the screen. You enter deferred mode by the "ESC" 
key. After this characters you type will be entered on the 
command line, When you type two "ESC" keys in sequence the 
command line is executed and the sditor returns to immediate 
mode, The command is left in the line and can be re-executed by 
typing “G. You can exit from deferred mode without doing any 
deferred command by deleting the entire command with a sequence 
of leftarrows or typing “X while in deferred mode. The deferred 
mode command elements are listed in table Z. The most important 
command is: 


(esc)Qlesc)(esc) which exits the editor normally, 
Making 2 new file, 
This is the first operation to be performed when producing some 
text. Suppose the file will be called DAMES.TXT, You first set 
the APEX default file name to this file} 

AFP XSDF DAMES.TXTCreturn) 


Now make the file; 


AFP XSMAKE Cspace) (return) 


The X renister, 


This is an auxilliary place to store text while moving it or 
repeating it, Any text you move backward over or delete while 
the X register extract mode is turned on will be put into the 
register, The register contents can be copied back into the text 
at the currect cursor position with a deferred mode command, 
Text “scooped" into the register remains there until specif- 
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ically deleted by a deterred command, 


At this point the operation cf the editor is best learned by 
trial and error; using the tables as guides. But remember, you 
will make errors so expect te loose your text frequently while 
you are learning! Note tnat return, space and (tab ars seen a5 
characters by the editor and can be inserted and deieted as 
such, 


IMMEDIATE MODE 


mast keys imsert the cmarecter st the cursor, 
lefterrow aelete tne cnaerscter bhenind the cursor, 
rebar begin 38 mew Line. 

ese enter deferred mode. 

I imsert a tab 

“{Q MOVe Oursar " ack, ome cnarseter, 

AW Mave cursor up @ Lime. 

oo move cursor to start of taxt. 

A move cursor forward ome cneracter. 

AS MOVE Cursor down ome Line, 

mp move cursor to the end of the text. 

AX Gelete the line benind the cursor. 

AG | re-executea tie commasend im tne command line, 
a4 show special chseracters Cagain to turm off). 
AY | show limes thet sre too long (again to burr 
ies Lurr K register extractor or. 

AF turn X register extractor off. 

2 imsert 3 "form feed" (mew psee om printer) 
a Sw3p to system discardine all edits. 

aes shift to the other csse, | 
rieantarrow indent this line the same as the last. z 
is 4 imsert open square bracket. 


snift M insert close square bracket. 
a insert backslash, 
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QO" 


Ee ere Se 


Piraeh ese sep aerpeLes COMmMaerndis were wurtlear, 

B@cGrd G@aec exnecube commend Line, teturnm to dam. mode, 
a move cursor forward cme cmsracter, 

fe move cursor backward one cherecter, 

fe move cursor forward to mext form feed, 

( qelete cnerseter mening tne cursor, 

FR Gelete rest of line, ine. tie return. 

Z Ge@lete tackwaerd to previous form feed (Crap), 
‘ aq@lete current S&S register content. 

‘ Gelate entire editor contents tkilld. 

; imsert X register content st cursor, 

Hci imgert the cnaerascter whose hex Ssclil is rm. 
Lex (ese) ITi2eT GS CORR Sb our sors, 

See Caso) searen forward for Use. 

Mosse C@SO) searcn, if fail do G and repeat. 

J if status is OK repeat command line. 

i imdenmt this line as last. 


remargim this paregraph usimnea last margins, 
tiem TemMar@gin, setting left tom & rignt to om. 

oper (reopen) input and output files, 

append from input file to editor. 

write current editor content, eet more, 

delete current editor content, eet more Cysnk) 

“Lt writing mew file with changes. 


sC 
re 


ws“ 6) Pt aS 


WW write curremt comtenmt only to file. 

» close output file immediately, 

c sbort hack to AFEX. Discard edits, 
List camtemts to AFEX device #2, 

te, mob useq yet. 


Note: Almost all deferred commands can be executed a given 
number of times by preceeding the command character by a number, 
eg. “lesc)sDiesclesc)" will delete three characters, The 
exceptions are where it does not make sense as in J and K, 


Some hints: 


The following hints are for the experienced APEX/VED user, It 
will take some experience to understand the processes described. 


In APEX if you exit via “P then you may re-enter with the 
APEX "START" command, Thus we have a mechanism for picking up 
a part of one file and putting it into another, by returning 
to APEX, opening a new set of input and or output files and then 
Swapping back to the editor, When you swap back you have to open 
and append from the new file explicitly with "Oa", 


If you insert too much into the editor buffer so the output file 
becomes full before all of the text is written out you will get 
an IO error when you use "G", You can recover by closing the old 
output file, “P’ing tack to APEX, opening a new autput file 


with another name, re-starting the editor and dumping’ the 
Unwritten text to the new file with “OWC", Then you can make 
Some more disk space and put the two aarts back together. 
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AFEX AND BASIC WERE NOT DESIGNED FOR EACH OTHER, AS WERE APPLE 
CoS AND AFFLE EBASIC, IN FACT THERE ARE LANGAUGES UNDER APEX Ther 
ARE BETTER THAN EASIC FOR ALMOST EVERY AFPFLICATION, RESPITE THI 
"ASTC LIVES ON AND WORKS WELL UNDER APFLE 20S. STILL THERE HAVE 
RPEeM MaMY REQUESTS FOR TNFOQRMATIOMN OM RUNNING beSIC UNDER ArEX 
AND SO A LIMITED ILLUSTRATION OF ONE MEANS TO MARRY AFEX AND 
EASIC HAS BREN MADE, 


THE FROGRAM "BASIC.SAV" IS THE FUNDAMENTAL INTERFACE MODUL TO 
CONNECT APEX AND INTEGER &ASIC. TO USE IT YOU MUST HAVE INTEGER 
BASIC IN ROM, EITHER NORMALLY OR ON AN ENABLED ROM CARD. 


TO SIMFLY ENTER EASTIC UNDER AF EX TYPE? 
APX>BASIC CRETURN) 


THE BEHAVIOR OF BASIC UNDER AFEX IS SOMEWHAT OLTFFERENT GECAUSE 
BOS IS NOT RESIDENT AND ALL BASIC T/0O IS FUNNELED THROUGH THE 
STANDARD AFEX HANDLERS (NORMALLY APEX DEVICE 1). YOU WILL FIND 
SOME SIGNIFICANT ADVANTAGES TO THIS ARRANGEMENT AS WELL AS A FE 
DISADVANTAGES, : 


THE FRIMARY ADVANTAGES ARE THAT UNDER APEX? 


1) BASIC FROGRAMS CAN BE EDITED BY ANY OF THE AFEX EDITORS WHIC!I 
OFFER A SIGNIFICANT IMPROVEMENT OVER THE BUILT IN BASIC EDITOR, 


2) AFEX DEVICE HANDLERS ARE USED WHICH FROVIDES A LEVEL OF 
INTERFACING CAPABILITY THAT WAS MISSING BEFORE. USING ARFEX EAST! 
CAN INTERFACE CLEANLY TO EXCEF TIONAL DEVICES. THESE HANDLERS 
FROVIDE & BETTER MECHANISM FOR INTERRUFTING FROGRAMS, STOFFING 
FRINTOUT AND TYPING LOWER CASE OR OTHER CHARACTERS NOT NORMALLY 
AVATISABLE FROM THE ARPFPLE KEYEOQARD,. 


3) BASIC PROGRAMS UNDER APEX CAN BE LOADED WITH ASSEMELY 
LANGAUGE COMPONENTS WITHOUT OBSCURE KLUGES. ALL YOU HAVE TO DBO 
ITS MOVE HIMEM DOWN, FUT THE MACHINE CODE IN THE FREE SFACE AND 
SAVE AS USUAL. THE ADDED CODE WILL AUTOMATICALLY BE INCLUDED IN 
THE SAVE FILE. MORE IMPORTANTLY, MACHINE CODE COMPONENTS CAN EE 
WRITTEN USING THE STANDARD AFEX ASSEMBLER AND SO ARE EASILY 
GENERATED. 


4) BASIC FROGRAMS SAVED UNDER AFEX AS ",.SAV" FILES LOAD MUCH 
FASTER THAN THEY DO UNDER DOS. 


A MAJOR FOINT IS THIS: APEX IS HOOKED INTO BASIC VIA THE I/O 
VECTORS IN PAGE 0. THUS IF YOU RESET TO THE ROM MONITOR, AFEX 
IS NO LONGER HOOKED IN. TO RESTART BASIC FROM THIS FOINT YOU 
MUST USE THE AFEX RESTART VECTOR? 


REF OOG CRETURN > 
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DO NOT TYFE CTRL-C OR CTRL-B TO THE ROM MONITOR OR ALL IS LOST. 


IF YOU HAVE AN APEX TEXT FILE CALLED, SAY, “FROG.EBAS", YOU CAN 
LOAD ITT INTO &ASTC WITH THE ARIEX COMMAND? 


APS eRASTIOC FROG CRETURE } 


ONCE LOADED THE FROGRAM CAN BE DEALT WITH UNDER BASIC A$ USUAL. 
T.E. RUN, MODIFIED, LISTED ETC. THE FROGRKAM CAN BE WRITTEN GACK 
(ONCE ONLY) TQ AN APEX TEAT FILE EY A COMMAND TO EASIC, NAMELY? 


PCCTREYDIE TST IRE TURN) 


& BASTC FROGRAM CAN BE SAVED UNDER AREX AS A NORMAL. (Mis FEY # -. 
APEX ".,.SAY" FILE. TO BO THIS, BRLT BASIC WITH CTRL-F, THEN IN 
AF EX TYFES | | 


Ar ASSAVE FROGCRETURE) 


YOUR FROGRAM WILL BE SAVED AS THE FILE "FROG.SAV" AND CAN BE RU 
LIKE ANY OTHER AFEX ".SAV" FILES: 


AF X=FROG (RIETURN ) 
MOVING FROGRAMS FROM DOS TO AFEX? 


FIRST NOTE THAT THIS IS NOT ALWAYS FOSSIELE, FOR ANY NUMEER OF © 
REASONS, SUCH AS THE FROGRAM USES AFFLE DOS OR THE FROGRAM USES 
SOME MACHINE CODE WHICH IS EMBEDDED INTO THE FROGRAM EY 

KLUGING BASIC’S FROGRAM SFACE FARAMETERS {SYMPTOM ur Too Lo ou 
PROGRAM LISTS AS FARTIALLY JUNK). 


HOWEVER, IF ITS A NORMAL SORT OF BASIC FROGRAM THE FROCESS IS | 
AS FOLLOWS, USING NOT "BASIC.SAV" BUT "BSAVE.SAU", (WHICH IS THI 
SAME FROGRAM EXCEPT LOCATED SO AS NOT TO CONFLICT WITH AFEX OR 
POS, AT THE EXPENSE OF AVATLABLE MEMORY), 


i> BOOT DOS 


2) RESET HLAEM BY 
| TLE 24997 OS RETURN) 


3) LOAD THE FROGRAM FROM POS AS USUAL? 
“LOAD FROG 


4) RESET OR CALL -151 TO GET TO THE ROM MONITOR. MAKE A NOTE 
OF THE CONTENTS OF LOCATIONS $CA AND $CE. 


2) INSERT AFEX SYSTEM DISK AND BOOT IT WITH? 
KSCCTRI-FO CRETURN 


6) FROM AFEX FUN ESAVE WITH THE FILE YOU WANT AS QUTFUT FILE. 
Be Sua. TO ourr i? NU DNPUT Paik: USE Tai a SS LENS 
ORRPASESAVE FROG. BAS CRETURN} 


7) RESET SACK TO THE ROM MONITOR AND CHANGE $CA AND $CE Gack TO 
WHAT THEY WERE. | 
RESTART BASIC USING THE APEX RESTART VECTOR? 

KEFO0G (RETURN) | | 
@) WRITE THE FILE QUT WITH 

» (OTRL =O) LIST (RETURN) 

10) EXIT BACK TO AFEX WITH CTRL-F. 
THE PROGRAM WILL NOW EXIST AS THE FILE "FROG.BAS". IT CAN 
MANIFULATED, SAVED ETC. AS ABOVE, 


ONC AT 


This program concatenates any number at APEX text files, 
The Gutput file is specified in the run lins: 


Braveunuea!) BlgriLe.aLt 


The input files will be prompted for; one by one, When 
complete, answer the prompt with a return alone, The 
cutput fila will then be closed and control will) return 
to APEX, 


The source for this program illustrates several aspects 
of XPLO under APEX, ) 


In order to make the correct "SAV" file from the source remember 
to set the defaults so that it expects an output rile but no 
input file, 


DIsASM 


This is a 6502 code dis-assembler that produces a disassembly 
that is compatible with the APEX assembler format, It will also 
produce a list cf label locations, 


The output file, if any, is specified in the run iine} 
APASDISASM FROG. FSS 

The program will ask for. memory limits (in hex) and for the 

device to use. The device is any standard APEX device that 


you have a handler for. Give device 3 if you want the results 
to go to your output file, 


The “real resident address" is the actual address the code will 
be when it runs. The feature is provided in order to correctly 
' deal with ROMs which are read elsewhere than where they reside, 


This program illustrates the use of data structures in XPLO, 


The BOOSTER cn this disk (Vi.1) will six 2 preblem with the sid 
version. The cld version wrote the currant date into the system 
blacks of the disk, thus making it permanent, The new version 


° A = = rN =< —_, \ 1 p Be po alee a tae : a ie ~~ ee 
will avied deing this-+so that avery Time you ocot, area wil get 
tne jatest data rrom the dirsctery sn the ccet disk. 
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